home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 15 Orphan Computers / BFILES.TXT < prev    next >
Text File  |  2019-04-13  |  17KB  |  300 lines
  1.       OUTLINE OF THIS FILE
  2.   I. Liz Deal's Contributions
  3.      A. Pre-SuperScript
  4.      B. Keytrix
  5.      C. Supermon
  6.      D. Disk Utilities
  7.      E. Spooling
  8.      F. Machine Language
  9.      G. Others
  10.  II. Gord Campbell's Programs
  11. III. The CBM 8032 Emulator
  12.  IV. Manfred Mager's Monitor
  13. -----------------------------
  14.    I. Liz Deal's Contributions
  15.       A. Pre-SuperScript
  16.             CompuServe name:  PRESSC.BIN
  17.             Original name:   "pre-superscript" (Basic program)
  18.    SuperScript II, one of the very best word processing programs ever written
  19. for any brand of computer, was designed for the British version of the B128,
  20. the Commodore 700.  Even after four years this is the only software for any
  21. microcomputer known to permit column moves (aside from dedicated
  22. wordprocessors), and many other advanced features are also included.  Yet two
  23. major problems occur when running SuperScript on the B128: keybounce (a letter
  24. prints twice when you touch a key just once) and erratic cursor movement (the
  25. cursor will only move four or five places when you hold down the cursor key,
  26. then it pauses for a second before resuming).  Both problems are due to the
  27. British use of 50 cycle AC, while American computers are plugged into a 60
  28. cycle network.  Liz Deal wrote this program, which will fix both bugs if you
  29. run it before loading SuperScript.  This magic is accomplished by a machine
  30. language routine which intercepts the hardware interrupts, and which is a
  31. separate file on CompuServe:
  32.             CompuServe name:  IRQ400.BIN
  33.             Rename to:       "+ta irq.400" (machine language program)
  34. Another CompuServe file contains a thorough explanation of what creating this
  35. patch involved:
  36.             CompuServe name:  IRQRTE.BIN
  37.             Original name:   "b128 irq rate" (Basic program)
  38. Although this is a Basic program, it cannot be run: just load it and LIST to
  39. read the explanation.
  40. ----------------------------------------
  41.       B. Keytrix
  42.             CompuServe name:  KEYTRX.BIN
  43.             Original name:   "keytrix v4" (Basic program)
  44.    Keytrix is an indispensible aid for anyone programming the B128 in Basic.
  45. Several keywords are added to Commodore's Basic 4.0 commands, allowing
  46. the user to do such things as renumber a program, list a program from disk
  47. without loading it into memory, read sequential files from disk without
  48. disturbing the program in memory, merge programs on disk (including subroutines
  49. stored as program files) with the program in memory, find specified keywords,
  50. variable names, and/or strings in the program in memory and automatically
  51. change them if desired, and other useful functions.  What's more, Keytrix
  52. uses the function keys F9 and F10 to scroll back and forth through the program
  53. in memory, ending the need to use LIST every time you have to check on a line
  54. which has scrolled off the screen.
  55.    Keytrix uses 3 machine language routines to accomplish its lightning-fast
  56. work.  These 3 routines need to be on the same disk as Keytrix, and must have
  57. the exact name specified in the program.  B128 users will need these 3 files:
  58.             CompuServe name:  Rename to:
  59.             1128.BIN          "+b1 kxb128.v4" (machine language program)
  60.             15128.BIN         "+b15kxb128.v4" (machine language program)
  61.             15128P.BIN        "+b15kxb128.v4+" (machine language program)
  62. B256 users will need these 3 files for Keytrix:
  63.             CompuServe name:  Rename to:
  64.             1256.BIN          "+b1 kxb256.v4" (machine language program)
  65.             15256.BIN         "+b15kxb256.v4" (machine language program)
  66.             15256P.BIN        "+b15kxb256.v4+" (machine language program)
  67. Brief instructions for the use of Keytrix are provided in the next file:
  68.             CompuServe name:  KEYINS.BIN
  69.             Original name:   "keytrix v4.ins" (Basic program)
  70. --------------------------------------------------------
  71.       C. Supermon
  72.             CompuServe name:  SUPMON.BIN
  73.             Original name:   "supermonb v5" (Basic program)
  74.    Liz Deal has adapted the famous Supermon program for the B128.
  75. Supermonitor offers machine language programmers an alternative to the built-in
  76. monitor provided by Commodore.  Once again, it operates through machine
  77. language.  The following four files are needed to run the program above:
  78.             CompuServe name:  Rename to:
  79.             SMB04.BIN         "+smb v5.0400" (machine language program)
  80.             SMB0E.BIN         "+smb v5.e000" (machine language program)
  81.             SMB04P.BIN        "+smb v5.0400+" (machine language program)
  82.             SMBE0P.BIN        "+smb v5.e000+" (machine language program)
  83. Brief instructions for the use of Supermon are provided in the next file:
  84.             CompuServe name:  SMBINS.BIN
  85.             Original name:   "supermonb v5.ins" (Basic program)
  86. ---------------------------------------------------------------
  87.       D. Disk Utilities
  88.    Liz Deal has provided several disk utilities for the B128, most of them
  89. adaptations of programs by Jim Butterfield.
  90.             CompuServe name:  DSKLOG.BIN
  91.             Original name:   "disk logger.b128" (Basic program)
  92. If you want to see a directory of the files on your disk, you can just issue
  93. the DIRECTORY or CATALOG command, or you can get a real fancy directory by
  94. running this program.  It needs one machine language routine:
  95.             CompuServe name:  LOG400.BIN
  96.             Rename to:       "+disklog.400" (machine language program)
  97. As before, the name of the machine language program must be exactly as
  98. specified in the Basic program which calls it.
  99.             CompuServe name:  DSKMOD.BIN
  100.             Original name:   "diskmod.b128" (Basic program)
  101. With this program you can choose any track and sector on your disk that you
  102. want to modify.  The bytes will be shown (in hexadecimal) on the screen; use
  103. the screen editor to change any bytes to whatever you want, and the program
  104. will make the same changes on your disk for you.
  105.             CompuServe name:  DSKVEW.BIN
  106.             Original name:   "disk view.b128" (Basic program)
  107. This program is similar to the previous one in that it displays whichever
  108. disk track and sector you specify, but it protects you against making
  109. unintentional changes on your disk.
  110.             CompuServe name:  COPALL.BIN
  111.             Original name:   "copy-all b128.3" (Basic program)
  112. This program is intended to allow you to copy any number of files from one disk
  113. to another, in whatever order you choose, but it requires a machine language
  114. routine which is not available on CompuServe.
  115.             CompuServe name:  CHGDEV.BIN
  116.             Original name:   "change dev#" (Basic program)
  117. Commodore disk drives are pre-set at the factory to be device number 8.
  118. If you have more than one drive unit, you can use this program to fool your
  119. computer into thinking one of them has a different device number.
  120.             CompuServe name:  BIGREL.BIN
  121.             Original name:   "big rel file" (Basic program)
  122. The 8050 disk drive can handle the same jumbo-sized relative files as the 8250.
  123. Run this program to command your 8050 to use the 8250 relative file routines.
  124.             CompuServe name:  EXPREL.BIN
  125.             Original name:   "8250 expand rel" (Basic program)
  126. This program came from the 8250 demo disk.  Unless you have that disk, you
  127. cannot run it because it needs a DOS machine language routine found on a
  128. certain block of that disk.
  129. ---------------------------------------
  130.         E. Spooling
  131.             CompuServe name:  SPOOL.BIN
  132.             Original name:   "spool b128" (Basic program)
  133.    Spooling is a technique which allows the computer to be free to run programs
  134. while the disk drive is in use, typing out a file on the printer.  Liz Deal
  135. wrote this one for the B128.  Of course, any program you run will not be able
  136. to access the disk drive while it is in use.
  137.             CompuServe name:  WSPOOL.TXT
  138.             Original name:   "w.b128 spool" (sequential file)
  139.    This is a SuperScript II sequential file which explains how spooling works.
  140. ------------------------------------------------------------------------------
  141.         F. Machine Language
  142.             CompuServe name:  DCLPAL.BIN
  143.             Original name:   "dcl b128.pal" (Basic program--load & list)
  144. This is a detailed memory map for the B128, formatted for use in the PAL
  145. assembler.
  146.             CompuServe name:  WXCALL.DOC
  147.             Original name:   "w.b128 xcalls" (sequential file)
  148. An extensive discussion of machine language programming in the B128, and in
  149. particular the setup needed before code in a nonsystem bank can access the
  150. Kernal routines, or in fact any routines outside its own bank.
  151.             CompuServe name:  BTXFER.BIN
  152.             Rename to:       "+btxfer.fe48" (machine language program)
  153. Here's the transfer of execution code essential for bank-hopping, as explained
  154. in the file above.
  155.             CompuServe name:  XCALL.BIN
  156.             Original name:    "xcall" (Basic program--load and list)
  157. Liz Deal wrote this program to demonstrate how to create a pseudo-jump table
  158. in a machine language routine.  Details are given in WXCALL.DOC, above.  This
  159. file is actually the source code for an assembly language program, and it
  160. contains a commented disassembly of the machine code.
  161. -----------------------------------------------------
  162.         G. Others
  163.             CompuServe name:  WEXP15.BIN
  164.             Original name:   "w.exp15" (sequential file)
  165. A text file which explains how you can adapt your CalcResult cartridge to
  166. serve as extra RAM in bank 15.
  167.             CompuServe name:  CON128.BIN
  168.             Original name:   "configure b128" (Basic program)
  169. Liz wrote this little program for those who don't use Keytrix or Supermon.
  170. It will relocate the Basic program text area to $401, where it resides in the
  171. PET/CBM computers.
  172.             CompuServe name:  PRIMES.BIN
  173.             Original name:   "primes" (Basic program)
  174. Lets you type in any integer as a limit, and it will print out all the prime
  175. numbers from the beginning up to the limit.
  176.             CompuServe name:  Original name:
  177.             LOBAS.BIN         "b128lo.bas" (program-type file)
  178.             HIBAS.BIN         "b256hi.bas" (program-type file)
  179.             LOKER.BIN         "b128lo.ker" (program-type file)
  180.             HIKER.BIN         "b256hi.ker" (program-type file)
  181. These four files are memory dumps of the standard B128 and B256 Basic ROMS
  182. and Kernal ROMS.  Compare them with your own machine's ROMS to see if you
  183. have the main production model, or an early version released before all the
  184. bugs were worked out.
  185.             CompuServe name:  QPLOT.BIN
  186.             Original name:   "qplot.b128" (Basic program)
  187. Lets you draw graphs on the screen.
  188.             CompuServe name:  VER128.BIN
  189.             Original name:   "verifizerb128" (Basic program)
  190. The function of this program is not explained.
  191. ----------------------------------------------
  192.  II. Gord Campbell's Programs
  193.         Gord Campbell prepared these programs for their original release on
  194. a TPUG disk.
  195.             CompuServe name:  LISTME.BIN
  196.             Original name:   "list-me.bu" (Basic program--load and list)
  197. Brief description of the rest of the files in this section.
  198.             CompuServe name:  SAMPLE.BIN
  199.             Original name:   "sample boot.b" (Basic program)
  200. Shows the procedure for loading a machine language program from Basic.  To run
  201. this program, you will need to have the next three files as well.
  202.             CompuServe name:  TESTBA.BIN
  203.             Rename to:       "test.basic" (Basic program)
  204. General instructions for loading a machine language program from Basic.  This
  205. program is loaded and run by the preceeding file.
  206.             CompuServe name:  TXRAM.OBJ
  207.             Rename to:       "txram obj" (machine language program)
  208. Another version of the transfer of execution code.  Liz Deal's version fixes
  209. a bug in it.  This name needed to run SAMPLE.BIN above.
  210.             CompuServe name:  SAMOBJ.BIN
  211.             Rename to:       "sample obj" (machine language program)
  212. This code is not run, it is just included for demo purposes.  SAMPLE.BIN,
  213. above, will not work without it.
  214.             CompuServe name:  FLASHB.BIN
  215.             Original name:   "flash.bas.b" (Basic program)
  216. A demo program which will draw a border around the screen and flash it on and
  217. off once every second.  It works by loading the following interrupt-driven
  218. machine language program:
  219.             CompuServe name:  FLASHO.BIN
  220.             Rename to:       "flash.obj" (machine language program)
  221. Study this program to see the proper way to set up and run machine code hooked
  222. up to the interrupt vector.
  223.             CompuServe name:  FLSHML.BIN
  224.             Original name:   "flash.8.1" (program-type file)
  225. This is the source code of the preceeding file, for use with the MAE assembler.
  226.             CompuServe name:  HEXDMP.BIN
  227.             Original name:   "hex dumper.z" (Basic program)
  228. Creates a dump on your screen of any file on your disk.  Uses the same format
  229. as Liz Deal's disk utilities, but you do not have to know which track and
  230. sector the file starts on.
  231.             CompuServe name:  MEMDMP.BIN
  232.             Original name:   "mem dump.b" (Basic program)
  233. Creates a similar dump to the program above of the code in Bank 15, beginning
  234. at any location you specify.
  235.             CompuServe name:  CHGADD.BIN
  236.             Original name"   "chg ld addr v1.2" (Basic program)
  237. To load a Basic program in the PET/CBM computers, the program header must
  238. contain a load address of $401.  If you have a B128 program (or one for any
  239. other Commodore model) that you want to use in a PET, be sure it has the
  240. proper header by running this program first.
  241.             CompuServe name:  ERRLST.BIN
  242.             Original name:   "err$ list.b" (Basic program)
  243. Run this program to make a list of all the error messages used by the B128.
  244. Or just look in Appendix J and K of the computer manual.
  245. --------------------------------------------------------
  246. III. The CBM 8032 Emulator
  247.             CompuServe name:  START2.BIN
  248.             Original name:   "Start8432.21" (Basic program)
  249. This B128 Basic program will make your computer emulate the CBM 8032, so you
  250. will be able to run some 8032 programs on it.  This program comes from Germany,
  251. where many B128's were sold before there was any software for it.
  252. It requires the next six files:
  253.             CompuServe name:  Rename to:
  254.             8432-2.BIN        "8432.21" (machine language program)
  255.             BANKF2.BIN        "bank F.20  '1024" (machine language program)
  256.             T1.BIN            "t1" (machine language program)
  257.             T2.BIN            "t2" (machine language program)
  258.             TD.BIN            "td" (machine language program)
  259.             TD-ALT.BIN        "td.alt" (machine language program)
  260. The last four files in the list define which character is printed for each key
  261. on the keyboard.  B128 users really need only T1.BIN, the default option.  The
  262. other three are available for users with other types of keyboards.
  263.             CompuServe name:  INST.BIN
  264.             Original name:   "instructions8432" (Basic program)
  265. Very brief instructions for using the Emulator program.
  266.             CompuServe name:  SMBREL.BIN
  267.             Original name:   "supermon.4.rel" (Basic program)
  268. This is Liz Deal's version of Supermon for use with the Emulator.
  269.             CompuServe name:  Original name:
  270.             AID46B.BIN        "aid4.6b00" (machine language program)
  271.             AID47B.BIN        "aid4.7b00" (machine language program)
  272. The two files above come from Liz Deal as well. Use the second one with the
  273. Emulator if you do not use Supermon; use the first one if you do use
  274. Supermon with the Emulator.  They contain a tiny Basic aid, which adds
  275. such commands as Delete and Renumber to the 8032 Basic vocabulary.
  276.             CompuServe name:  Original name:
  277.             BM1.BIN           "bm1" (Basic program)
  278.             BM2.BIN           "bm2" (Basic program)
  279.             BM3.BIN           "bm3" (Basic program)
  280.             BM4.BIN           "bm4" (Basic program)
  281.             BM5.BIN           "bm5" (Basic program)
  282.             BM6.BIN           "bm6" (Basic program)
  283.             BM7.BIN           "bm7" (Basic program)
  284.             BM8.BIN           "bm8" (Basic program)
  285. These 8 benchmark programs, provided by Jim Butterfield, are meant to be run
  286. on the Emulator to show that 8032 programs will execute faster on the B128 with
  287. the Emulator than they will on the 8032 itself.
  288. -----------------------------------------------
  289.  IV. Manfred Mager's Monitor
  290.         Yet another machine language Monitor.
  291.             CompuServe name:  EXTRA2.BIN
  292.             Original name:   "extra monitor" (machine language program)
  293. This monitor resides totally in bank 15.
  294.             CompuServe name:  EXTRA1.BIN
  295.             Original name:   "extra mn inst" (Basic program)
  296. Instructions for installing the previous file and using the monitor.
  297.             CompuServe name:  EXTRA3.BIN
  298.             Original name:   "extra monitor.s" (Basic program--load and list)
  299. The source code for the file above.